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EXHIBIT B 



Initial Release 4.5 



Function : Calendaring and Scheduling 
SchRetrieve - Retrieve a schedule. 



#include <schedule.h> 



STATUS LNPUBLIC SchRetrieve( 
UNID FAR 'pApptUnid, 
TIM ED ATE FAR *pApptOrigDate, 
DWORD dwOptions, 
TIM EDATE_P Al R FAR 'pinterval, 
LIST FAR *pNames, 
HCNTNR FAR VethCntnr, 
void FAR *MustBeNuli1, 
void FAR *MustBeNull2, 
void FAR* FAR *MuStBeNull3); 



Description : 

Synchronously retrieves a local or remote schedule by asking the 
caller's home server for the schedule. 

The ONLY time that local busy time is used is when the client is in 
the Disconnected mode which is specified through the location document. 
Otherwise, the API will route ALL lookup requests to the users home server 
for processing. 



Parameters : 



input : 

pApptUnid - Ignore this UNJD in computations. 
pApptOrigDate - Reserved, Must beset to NULL. 



dwOptions - Option flags: 

SCHRQST_COMPOSITE return composite schedule 
SCHRQST.EACHPERSON return each person's schedule 
SCHRGSTJ.OCAL do only local lookup 

SCHRQST^FORCEREMOTE force remote even if you are using workstation based 
email 



plnterval - Pointer to a TIMEDATE^PAIR structure that specifies the 
range over which the free time search should be performed. In typical 
scheduling applications, this might be a range of 1 day or 5 days. 

pNames - Pointer to a list of fully distinguished names whose schedule 
should be searched. This list is in TEXTJJST format without the datatype 
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work. This list can be conveniently built with the textlist package. 
MustBeNulH - This parameter must be NULL 
MustBeNull2 - This parameter must be NULL. 
MustBeNull3 - This parameter must be NULL. 
Output ; 

(routine) • NOERROR - Successfully retrieved a schedule. 
ERR_xxx - There are many possible errors. It is best to use the code in a 
call to OSLoadString and display/log the error for the user as your default 
error handling. 



rethCntnr - Handle of schedule container results are returned in. If 
'rethCntnr is NULLHANDLE, then the container will be allocated by this 
call. If it is not NULLHANDLE then the cafler has allocated it and is 
responsible for freeing it on all errors. 



See Sample Program : 
MISC\SCHEDULE 
See Also : 

SchContainer_Free 
SchSrvRetrieve 



SCHRQST xxx 
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